home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / utility / 647 / editv2_1 / editv2_1.man < prev    next >
Text File  |  1990-07-16  |  12KB  |  243 lines
  1. Text Screen Editor
  2. Version 2.1
  3. by Damien M. Jones
  4. Copyright © 1990 Damien M. Jones
  5. July 17, 1990
  6.  
  7. You may want to print this file out.
  8.  
  9. What should have been in the LZH file:
  10.      EDITV2_1.PRG   The editor program.
  11.      EDITV2_1.HLP   The help screen.
  12.      EDITV2_1.MAN   This file.
  13.      IBM.FNT        The IBM character font.
  14.  
  15. What this program is for:
  16.      This program is useful anytime you need to create a text 
  17.      screen.  It allows you a flexible method for adding color to 
  18.      old text screens and for making new ones.  Personally, I use 
  19.      it to make screens for my BBS (which I'm still working on), 
  20.      but anywhere one screen of colorful (or plain and drab) text 
  21.      is needed, this program comes in handy.
  22.  
  23. What this program is NOT for:
  24.      This program does NOT handle animation!  It produces text 
  25.      files that start in the upper left corner and proceed to the 
  26.      bottom of the screen.  The only difference between its files 
  27.      and normal ASCII files is the VT52 color control sequences 
  28.      that are automatically inserted for you.
  29.  
  30. How to use this program:
  31.      This program really isn't that difficult to use.  That's the 
  32.      way I planned it.  It does not, however, use menus.  I think 
  33.      that if you're going to be typing most of what goes on the 
  34.      screen, it's annoying to have to take your hands off the 
  35.      keyboard and grab the mouse.
  36.  
  37.      To load the program, make sure you have enough RAM.  About 
  38.      70K should be enough.  Run EDITV2_1.PRG from medium reso-
  39.      lution.  The program needs EDITV2_1.HLP and IBM.FNT in the 
  40.      same directory or the program will abort.  After the program 
  41.      loads those two files, it will present you with the help 
  42.      screen.  This screen was produced entirely with the program, 
  43.      so it's a good example of what can be done.  It is not meant 
  44.      to be a complete description of every function of the 
  45.      program, but merely something to jog your memory should you 
  46.      forget which key is which.  I have tried to make the 
  47.      commands as easy to remember as I could, and for the most 
  48.      part I think I did rather well.  Press any key to leave the 
  49.      help screen.  DON'T PANIC when you see the screen disappear-
  50.      -it can be recalled by pressing the HELP key.
  51.  
  52.      In the upper left hand corner of the now-blank screen you 
  53.      will see the cursor.  Whatever you type will be placed 
  54.      wherever that cursor is, and the cursor will move to the 
  55.      right as you type, similar to a typewriter.  Press the 
  56.      BACKSPACE key to back up if you make a mistake.  Press the 
  57.      RETURN key to proceed to the next line.  Very easy.  Most 
  58.      word processors work this way too.  You can use the arrow 
  59.      keys to move the cursor around as well, and you can press 
  60.      the HOME key (above the right arrow key) to place the cursor 
  61.      back in the upper left corner.  You can move the mouse 
  62.      pointer to any spot on the screen and press the left button.  
  63.      The cursor will move to that point.
  64.  
  65.      Now that you've got some letters and stuff on the screen, 
  66.      you're probably wondering where all the color is.  No 
  67.      problem.  Press the F2 key.  Type something.  Voila!  Red 
  68.      type!  Now press F3.  Type something.  Green text!  The 
  69.      first four function keys give you the four colors of text--
  70.      white, red, green, and black.  Press F4 to get back to black 
  71.      text.  Now hold down the shift key and press F3.  (That's 
  72.      how you get F13--press Shift and F3.)  Now type something.  
  73.      Black text--on a green background.  The keys F11 through F14 
  74.      (Shift and F1 through F4) give you the same four colors as 
  75.      text--but for the background.  Now, if you ever mix up the 
  76.      colors and can't tell what's what, you can press F5 to get 
  77.      back to your normal black text on white background.  Or, for 
  78.      something different, you can press F15 (Shift and F5) to get 
  79.      white text on a black background.
  80.  
  81.      It is important to note that the colors you have chosen will 
  82.      not affect anything on the screen until you type something. 
  83.      You can move the cursor all over the screen, but nothing 
  84.      will be changed until you type something.
  85.  
  86.      You can press the F6 key to "invert" the colors.  All this 
  87.      means is that you swap the text color and background color.  
  88.      So if you've got red text on a black background, you can 
  89.      press F6 and get black text on a red background.
  90.  
  91.      Now you know how to change colors, switch to a red 
  92.      background and move the mouse pointer to an unused portion 
  93.      of the screen.  Hold down the right button and move the 
  94.      pointer around.  You're "painting" with the current colors.  
  95.      This will erase whatever text you have on the screen, but 
  96.      it's a fast way to add colored boxes.
  97.  
  98.      If you press F16, you'll activate what's called "block 
  99.      inverse".  What this means is that instead of flipping the 
  100.      colors you're using, you can drag a box around a portion of 
  101.      the screen with the left mouse button, and everything inside 
  102.      of that box will have its colors flipped.
  103.  
  104.      Pressing F7 activates the "4-way" cursor.  With this option 
  105.      activated, the cursor will move in the direction it was last 
  106.      moved when you type something.  So if you move the cursor 
  107.      down, then type something, the cursor will move down instead 
  108.      of to the right as you type.  This is most useful for 
  109.      drawing boxes or other things on the screen.  Press F7 again 
  110.      to return to the normal cursor.
  111.  
  112.      Pressing F8 places you in "high ASCII" mode.  This allows 
  113.      you to type almost all of the special characters in the ST's 
  114.      character set, mostly composed of foreign letters and 
  115.      symbols.
  116.  
  117.      Pressing F9 puts activates "block painting".  You can use 
  118.      the mouse pointer and the left button to drag a box around a 
  119.      section of the screen.  You will then be asked if you want 
  120.      "X-Ray", "Block", or "Cancel".  "Cancel" gives you a chance 
  121.      to stop if you made a mistake.  "Block" fills the box with 
  122.      the current colors the same way as if you'd painted it with 
  123.      the right mouse button.  "X-Ray" makes the colors change, 
  124.      but all of the text will show through.  This is one great 
  125.      way to add color to old text screens... change the text 
  126.      color, and X-Ray paint a box over a word or paragraph.  Or, 
  127.      if you want to take all the color out of a screen, you can 
  128.      press F5 (for black text and white background) and then X-
  129.      Ray paint the whole screen.  Instant bleach!
  130.  
  131.      Pressing F10 "matches" the current colors to whatever colors 
  132.      are underneath the cursor.  So if you've just moved into a 
  133.      colored area of the screen, you can press F10 and the colors 
  134.      will be changed to match those that are already there, so 
  135.      you can type in the proper colors.
  136.  
  137.      Pressing F20 turns on X-Ray painting for the right mouse 
  138.      button.  With this on, you can paint with the right mouse 
  139.      button the same way that X-Ray block painting works.  This 
  140.      is another great way to add a splash of color to a drab 
  141.      screen--change the colors, press F20, and drag the right 
  142.      mouse button over a word.  Instant emphasis!  Press F20 to 
  143.      return to normal painting.
  144.  
  145.      That's all of the function keys.  The rest of the program's 
  146.      functions are activated by holding down the CONTROL key and 
  147.      pressing a letter key.  So CTRL-S means hold CONTROL and 
  148.      press S.
  149.  
  150.      Pressing CTRL-A allows you to enter a two-digit hex code for 
  151.      an ASCII character.  If you are making screens with the IBM
  152.      character set (see CTRL-F!) then this function comes in handy.
  153.  
  154.      Pressing CTRL-B lets you move a rectangular block of text 
  155.      from one location on the screen to another.  Drag a box 
  156.      around a section of the screen with the mouse pointer and 
  157.      left mouse button, just the same as if you were painting a 
  158.      block.  When you release the left mouse button, the block of 
  159.      text will "stick" to the mouse pointer.  Move it wherever 
  160.      you want it, and press the left mouse button again.  If you 
  161.      don't want to move the block, press the right mouse button.
  162.  
  163.      Pressing CTRL-C inverses the screen colors.  This does NOT 
  164.      change anything in the text file--it's just another set of 
  165.      colors to use.  Instead of white, red, green, and black, you 
  166.      get black, cyan, magenta, and white, respectively.  Press 
  167.      CTRL-C to return to the normal colors.
  168.  
  169.      Pressing CTRL-F allows you to access the IBM font.  This 
  170.      font contains some special characters for making lines and 
  171.      boxes.  However, this also does not change anything in the 
  172.      text file--it's just another set of characters to use to 
  173.      look at the file.  Some terminal programs can use this font 
  174.      and the other color set (DMJ Term comes to mind) so if 
  175.      you're making BBS screens you might want to consider it.
  176.  
  177.      Pressing CTRL-G shuts off the function keys.  This is useful 
  178.      if you need a special character that you get from the 
  179.      function keys.  For instance, you can press CTRL-G and then 
  180.      F3 to get the copyright symbol ©.  Press CTRL-G again to 
  181.      turn the function keys back on.
  182.  
  183.      You can press CTRL-L to load a text file.  If it contains 
  184.      color, it will be displayed in color, and you can change it 
  185.      as needed.  If it is too long to fit on the screen, you will 
  186.      only be able to see and edit the top part, and when you save 
  187.      the file, you won't save the rest of the file--only what you 
  188.      see on the screen.
  189.  
  190.      Pressing CTRL-N will erase the entire screen and reset the 
  191.      colors, and also move the cursor to the upper left-hand corner.
  192.  
  193.      You can press CTRL-P to save the current screen as a DEGAS 
  194.      medium resolution picture (.PI2).  When you do this, the 
  195.      colors you have selected (by using CTRL-C) are also saved.
  196.  
  197.      Press CTRL-Q to exit the program.
  198.  
  199.      You can press CTRL-R to redraw the screen if it gets messed 
  200.      up.  Occasionally I have noticed Quick ST to mess up the screen
  201.      slightly when the cursor and mouse pointer overlap.
  202.  
  203.      Finally, you can press CTRL-S to save the current screen as 
  204.      a text file.  After selecting the filename, you will be 
  205.      asked whether or not to "trim spaces".  If you do, the 
  206.      screen will be saved as a normal text file, with the VT52 
  207.      codes automatically inserted to change the colors.  These 
  208.      text files can be viewed from the desktop by double-clicking 
  209.      on the file and selecting "Show" from the alert box.  If you 
  210.      don't trim the spaces, the file will be saved "padded out"--
  211.      with spaces to make each line fill up the width of the 
  212.      screen.  This takes more disk space.  You shouldn't need 
  213.      this, but it's there, just in case...
  214.  
  215. I hope you find this program useful.  If you do, that's great, it 
  216. means I didn't waste my time writing this longer-than-expected 
  217. documentation.  If you'd like the source code, leave a message 
  218. for RGLOVER3 on GEnie, and it should make its way to me... soon I
  219. should have a BBS for you to call instead, and also a GEnie account
  220. of my own.
  221.  
  222.      -Damien Jones
  223.  
  224. Revision History
  225.  
  226. 2.1  Several bugs were fixed.  A small bug with the four-way cursor that
  227.      caused the regular cursor to move in the same direction as the
  228.      four-way cursor was fixed.  A bug with the CTRL-N function not
  229.      moving the cursor was fixed.  And a fairly major bug involving
  230.      files with no color was fixed.
  231.  
  232. 2.0  Color functions were added.  A normal typewriter style cursor mode
  233.      was added, to supplement the four-way cursor mode.  Defaults were
  234.      changed to match more people's desires.  Mouse movement of the
  235.      cursor was also added.  Documentation for the program was written.
  236.  
  237. 1.1  Some bugs were fixed, mostly with file handling.  The CTRL-P (Save
  238.      DEGAS) function was added.
  239.  
  240. 1.0  The original program was made, written mostly so I could edit
  241.      screens for the BBS program I was working on (and am still working
  242.      on).  It had limited control, no color, and no mouse support.
  243.